package com.chris.cc.user.service;

import com.chris.cc.common.exception.InvalidArgumentException;
import com.chris.cc.user.model.dto.RoleDto;
import com.chris.cc.user.model.entity.Role;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;

import java.util.List;

/**
 * Copyright (c) 2018-2025, chris All rights reserved.
 * <p>
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 * <p>
 * Redistributions of source code must retain the above copyright notice,
 * this list of conditions and the following disclaimer.
 * Redistributions in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 * Neither the name of the pig4cloud.com developer nor the names of its
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 * <p>
 * Author: haoka (haokang207@126.com)
 * <p>
 * Date: 2018/8/23 16:44
 **/
public interface RoleService {
    Role add(RoleDto role) throws InvalidArgumentException;

    /**
     * 分页查询
     *
     * @param userId  授予者用户ID
     * @param enable
     * @param keyword
     * @param page
     * @return
     */
    Page<Role> query(Long userId, Boolean enable, String keyword, Pageable page);

    Role toggle(Long id, Boolean enable);

    Role update(RoleDto role) throws InvalidArgumentException;

    List<Role> getByCode(String... code);

    /**
     * 获取用户的角色列表
     *
     * @param userId
     * @return
     */
    List<Role> getByUserId(Long userId);

    /**
     * 获取用户可以授予的角色列表
     *
     * @param userId
     * @return
     */
    List<Role> getPermittedRolesByUserId(Long userId);

    Role getById(Long id);

    /**
     * 获取角色可授予的角色列表
     *
     * @param roleId
     * @return
     */
    List<Role> getPermittedRolesByRoleId(Long roleId);

    /**
     * 更新可授予角色列表
     * @param roleId
     * @param ids
     */
    void updatePermitRole(Long roleId, Long... ids);

    /**
     * 更新用户的角色
     * @param userId
     * @param roleIds
     */
    void updateUserRole(Long userId, Long... roleIds);
}
